获取合同短链接 FAQ
返回合同签署、填写、查看链接,可用于短信、邮件或嵌入网页,便于在业务系统中完成合同签署相关操作。
如何生成合同短链接?
通过调用 GET /resrun-paas/kaifangqian/openAPI/V2/contract/pageUrl
接口,提供必要的参数即可生成合同短链接。主要参数包括:
contractId
:合同ID(必填)contact
:办理人账号(必填)taskId
:任务ID(可选)noLogin
:是否免登录(可选)pageUrlExpireTime
:免登录失效时间(可选)
免登录链接有哪些限制条件?
- 办理人必须已在电子签章平台注册账号
- 办理人必须拥有对应合同的待办任务身份
- 免登录失效时间默认为72小时(可自定义)
- 过期后需重新获取链接或登录验证
如何设置同步回调地址?
在返回的短链接后拼接编码后的callbackPage
参数:
https://home.kaifangqian.com/#/contract/detail/base?code=PxfgSHB1&callbackPage=https%3A%2F%2Fbaidu.com%3Fcode%3D001
其中callbackPage
的值需要进行URL编码。
参数contact的注意事项?
- 必须使用实际办理人的账号(邮箱/手机号)
- 不同身份使用不同账号:
- 发起人 → 发起人账号
- 签署人 → 签署人账号
- 抄送人 → 抄送人账号
禁止使用发起人账号获取其他签署人的链接(防止越权)
免登录失效时间格式要求?
格式必须为:YYYY-MM-DD HH:MM:SS
示例:2025-12-31 23:59:59
注意:时间必须晚于当前时间
链接免登录过期后如何处理?
- 重新调用接口获取新链接
- 当
noLogin=1
时设置新的pageUrlExpireTime
- 使用非免登录方式让用户自行登录